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S YSYEM AND METHOD FOR MEDIATING COMMUNICATION BETWEEN 
SOFTWARE APPLICATIONS 
Related Applications 
Ihe present invention claims priority from TJnite<l States Provisional Applications 
Nos. 60/235,915, filed Septembor28, 2000; 60/235,916, filed September 28, 2000; and 
60/235,91 7, filed September 28, 2000, all of which are.hereby Incorporated by reference in 
their entirety. 

Field of the Tnventtoii 

The present invention relates generally to the field of computer software applications. 
More specifically, the present invention relates to a method, system and protocol for 
mediating communication between software applications. 

Background of the Invention 

Portability of software applications between computing platforms has been an issue 
among software developers and users since beginning of the software industry. Platform 
independent languages such as Java have been developed in order to address this issue. 
However, Java and other languages claiming to be platform independent require an 
interpreter running on the same computing platform so as to convert the platform independent 
code into instructions the processor upon which the code is running on can understand and 
execute. Because of the requirement for an additional level of processing, i.e. interpreting, 
code written in Java and other platform independent langtiages typically runs less efficiently 
and requires relatively greater resources than code performing the same function in a 
processor's native language, code compiled specifically for the processor the code is running 
on. Therefore, code written in Java or another platform independent language usually runs 
slower than functionally equivalent code in a processor's native language, machine language 
produced by a compiler. 



One soiution for speeding up the performance of applications written in platform 
independent languages is to offload some operations to concurrently running applications 
written in the processor's native language and to use a mediation protocol to interact between 
the two applications. 
5 Summary of the Invention 

The present invention is a method, system and protocol for mediating communication 
between a first and second software application. As part of the present Invention, an 
application written in a first computer language may be compiled and/or linked to a first 
mediation module and an application written in a second computer language may be 
10 compiled and/or linked to a second mediation module. The first and second mediation 
modules may communicate with each other utilizing one or more protocols, providing for 
communication of various data types, including but not limited to function calls, function 
parameters, function results, and event notification. 

15 Brief Description of the Drawings 

The subject matter regarded as the invention is particularly pointed out and distinctly 
claimed in the concluding portion of the specification. The invention, however, both as to 
organization and method of operation, together with objects, features, and advantages thereof, 
may best be understood by reference to the following detailed description when read with the 

20 accompanying drawings in which: 

Fig. 1 Shows a diagrammatic illu.'rtration of two applications linked to and communicating 
through two mediation modules according to the present invention; 

Fig. 2 Shows a flow diagram illustrating the steps of by which a first application calls a 
function of a second function using the mediation modules of the present invention; and 
25 Fig. 3 Shows a diagrammatic illustration of a first application using several mediation 
modules. 
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It will be appreciated that for simplicity and clarity of illustration, elements shown in 
the figures have not necessarily been drawn to scale. For example, the dimensions of some of 
the elements may be exaggerated relative to other clemctiis for clarity. Further, where 
considered appropriate, reference numerals may be rejjefittjd among the figures to indicate 
corresponding or analogous elements, 

DETAILED DESCRTPTION 

In the following detailed description, numerous specific details are set forth in order 
to provide a thorough understanding of tlie invention. However, It will be understood by 
those skilled in the art that the present invention may be practiced without these specific 
details. In other instances, well-known methods, procedures, components and circuits have 
not been described in detail so as not to obscure the present invention. 

Unless specifically stated otherwise, as apparent from the following discussions, ii is 
appreciated that throughout the specification discussions utilizing terms such as "processing", 
"computitxg", "calculating", "determining", or the like, refer to the action and/or processes of 
a computer or computing system, or similar electronic computing device, that manipulate 
and/or transform data represented as physical, such as electronic, quantities within tlie 
computing system's registers and/or memories into other data similarly represented as 
physical quantities within the computing system's memories, registers or other such 
information storage, transmission or display devices. 

Embodiments of the present invention may include apparatuses for performing the 
operations herein. Tliis apparatus may be specially constructed for the desired purposes, or it 
may comprise a general purpose computer selectively activated or reconfigured by a 
computer program stored in the computer. Such a computer program may be stored in a 
computer readable storage medium, such as, but is not limited to, any type of disk including 
floppy disks, optical disks, CD-ROMs, magnetic-optical disks, read-only memories (ROMs), 
random access memories (RAMs) electrically programmable read-only memories 



(HPROMs), electrically erasable and programmable read only memories (EEPROMs), 
magnetic or optical cardi?, or any other type of media suitable for storing electronic 
instructions, and capable of being coupled to a computer system bus. 

The processes and displays presented herein are not inherently related to any 
particular computer or other apparatus. Various general purpose systems may be used with 
programs in accordance witli the teachings herein, or it may prove convenient to construct a 
more specialized apparatus to perform the desired method. The desired structure for a variety 
of these systems will appear from the description below. In addition, embodiments of the 
present invention are not described with reference to any particufar programming language, 
it will be appreciated tiiat a variety of programming languages may be used to implement the 
teachings of the inventions as described herein. 

The present invention is a method, system and protocol suitabje for mediating 
communication between an application written In a platform independent language, running 
on a specific processor or computing platform, and an application written in the processor's 
native language. As part of the present invention, an application written in a platform 
independent code may be compiled and/or linked to a first mediation module and an 
application written in the processor's native code may be compiled and/or linked to a second 
mediation module. The first and second mediation modules may communicate with each 
other utilizing a stream protocol providing for communication of various data types, 
including but not limited to function calls, function parameters, function results, and event 
notification. 

Turning now to Fig, there is shown a first application 100 linked to a tlrst 
mediation module 120, both of which may run in a single process. A second application 200 
is linked to a second mediation module 220. The first and second mediation modules may 
communicate with one another utilizing a stream protocol. In an embodiment of the present 
invention, the finst application 100 is written in a platform independent language, e.g. Java, 
and tlic first mediation module 120 causes the second application 200, written in the 



processor's native code, e.g. C, to be launched. The first mediation module 120 may issue a 
command causing the operating system to produce an instance of the second appJication 200 
and the second mediation module 220. 

The first application 100 may pass a function call to the second application 200 
5 through the first 120 and second 220 mediation modules, respectively. The second 
application 200 may pass the results of the function to the first application 100, also through 
the first 120 and second 220 mediation modules. In addition to passing function calls and 
their associated parameters, each of applications, 100 and 200, may also pass funclion results 
and event notification to the other. In one embodiment of the present invention, the 
1 0 application written in a platform independent or interpreted language passes a function cail lo 
an application written in the processors native code. 

Turning now to Fig. 2, there is shown a flow chart with the steps of a method 
accordmg to the present invention by which a first application passes a function call to a 
second application. As part of step 1000, a first application 100 issues a flinction call for a 
15 function contained within a second application 200. The first application's function call and 
associated parameters are passed to a first mediation module 120 where they are translated 
into a stream protocoi and transmitted. Step 2000. The function call and associated 
parameters, in the stream protocol format, are received by the second mediation module 220 
and translated into a format suitable for the secund application 200 (Step 3000). The second 
20 application 200 may return a value, a series of values, or some other result (Step 4000). The 
results may lake a reverse path back the First application 100, that is, through the second 
mediation module (step 5000) and through the first mediation module (step 6000). The first 
application 1 00 may receive the result in its own formal (step 7000) once the first mediation 
module 1 20 converts the results from the stream protocol (step 6000). 
25 Communication between mediation modules occurs using a stream protocol or other 

proiocol that may provide ordered delivery of data over muhiplc streams, for example 
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TCP/IP streams, A mediation protocol may be used over a communications protocol to form 
a stream protocol according to the present invention. 

The following is an example of functiotts performed by a mediation protocol 
according to the present invention: 
5 1. The first application may launch the seconci, providing it, by means of command- 

line arguments (or other mechanism) wit^i numbers of two TCP/IP ports to be 
used for communication between the two applications. The first port number is 
termed the Command Port and the second the Event Fort. 

2. The second application, when launched, stores the command port number and 
10 event port number for future reference in a place accessible to its mediation 

module. 

3. When the second application first attempts to perform an operation using its 
mediation module. It opens up a stream for event notifications by connecting a 
TCP/IP client socket to the event port. This is termed the Event Stream. 

15 4. When the second application requires that a function call be made through its 

mediation module, the following steps are performed: 

a. If this is the first time that a function call has been made trom the system 
thread from which the call is made, a new stream connection is opened up 
for the exclusive use of this tliread. This is done by connecting a TCP/IF 

20 client socket to the command port. Details of this connection are then 

stored for future reference. Each such stream connection has its Own 
memory buffers, and calls through one such stream connection arc 
executed independently of calls though another connection. This en.surcs 
thread-safety of the sysstem. 

25 b. If this Is not the first time that a liinctioQ call has been made from the 

current sy.stem thread, the second application's mediation module looks up 
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a coanection it has previously stored for this thread, and uses this 
connection. 

In order to call a function, the second application first needs a reference to 
the function to be called. This may have been stored from a previous use 
of the function, or may be acquired as follows: 

i. The second application's mediation module sends a request for a 
function reference number to the mediation module of the first 
application. Ihe request includes the package name, class name 
and method name ofa static Java method to be invoked. 

ii. The mediation module of the first application receives the request 
and uses Java's reflection mechanism to identify a method that 
matches the request. 

iii. The meditation module of the first application allocates a reference 
number for the method. It then stores this number and a reference 
to the method in a table for future reference. 

iv. The mediation module of the first application sends the reference 
number along "with details of the types of parameters, and the return 
type, of the requested method. 

V. The mediation module of the second application receives the 

reference number and the parameter types and return types, 
vi. The mediation module of the second application builds a data 
structure describing flie Java method and containing the reference 
number. It then returns this data structure to the second application 
as a remote function reference. 
The second application makes a function call through its mediation 
module, providing it with Che following information: 
i. A reference to a fUnclioti, as described above 



ii. The parameters to the function call 

iii. A memory address where the meditation motiule can store the 
result of the function cail. 

e. Tlie second application's mediation module passes the following 
information to the first application's mediation module: 

i. The reference number of the function 
ii. The parameters to the function call 

f. If, and only if; the function call is of a type that returns a result, the second 
application's mediation module waits for a result to be returned from the 
first application's mediation module before proceeding. 

g. If the function call is of a type that does not return a result, the second 
application's mediation module has nov/ completed its work for this 
function call, and returns control to the second application. 

h. The first application's mediation module receives the reference number of 
the function and its parameters. 

i. The first application's mediation module uses the reference number of the 
function to look up in a table a Java method reference that it has previously 
stored. This method is then invoked using Java's reflection mechanism. 

j. If the function call is of a type that returns a result, the first application's 
mediation module sends the return result to the second application's 
mediation module. 

k. The second application's mediation module returns the result of the 
fijnction call to the second application. 
When the first application requires that the second application be notified of some 
event, its mediation module sends a signal on the event stream. This signal 
contains no information in itself. 
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6. When the second application checks if any events ai^ waiting for il, its mediation 
module checks the event stream to see if any notifications are waiting on it. 

7. When the second applicalion has processed an event, its mediation module 
removes the event signal from the event stream. 

Turning now to Fig. 3, there is shown a diagrammatic iilastratioG of a first application 
using several mediation modules. A first application, for example a platform independent or 
interpreted application, may issue several function calls where each function is contained by a 
separate native code application. Fig. 3 shows a first application 100 comtnanicating with a 
second applica.tioa 200A through mediation modules 120A and 220A. The first application 
100 may also communicate a second application 200B througli tticdiation modules 120B and 
22()R. 

While certain features of the invention have been illustrated and described herein, 
many modifications, substitutions, changes, and equivalents will now occur to those skilled in 
the art. It is, therefore, to be understood that the appended claims are intended to cover all 
such modifications and changes as fall within the true spirit of the invention. 
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